TextSelectionテーマの移行

コンテンツ

まとめ

のThemeData外観を制御するプロパティマテリアルウィジェットで選択したテキストがに移動されました彼ら自身TextSelectionTheme。これらのプロパティには以下が含まれますcursorColor、textSelectionColor、とtextSelectionHandleColor。これらのデフォルトはマテリアルに合わせてプロパティも変更されました設計仕様。

コンテクスト

より大きな規模の一部としてマテリアルテーマの更新、新しいものを導入しましたテキスト選択のテーマ選択したテキストのプロパティを指定するために使用されますTextFieldとSelectableTextウィジェット。これらは、次のいくつかのトップレベルプロパティを置き換えます。ThemeDataマテリアルに一致するようにデフォルト値を更新します設計仕様。このドキュメントでは、その方法について説明しますアプリケーションはこの新しい API に移行できます。

移行ガイド

現在次のプロパティを使用している場合は、ThemeData新しいものを使用するには更新する必要があります。同等のプロパティThemeData.textSelectionTheme:

前	後
`ThemeData.cursorColor`	`TextSelectionThemeData.cursorColor`
`ThemeData.textSelectionColor`	`TextSelectionThemeData.selectionColor`
`ThemeData.textSelectionHandleColor`	`TextSelectionThemeData.selectionHandleColor`

移行前のコード:

ThemeData(
  cursorColor: Colors.red,
  textSelectionColor: Colors.green,
  textSelectionHandleColor: Colors.blue,
)

移行後のコード:

ThemeData(
  textSelectionTheme: TextSelectionThemeData(
    cursorColor: Colors.red,
    selectionColor: Colors.green,
    selectionHandleColor: Colors.blue,
  )
)

デフォルトの変更

これらのプロパティを明示的に使用していない場合は、ただし、以前に使用されていたデフォルトの色に依存しますテキストを選択するには、新しいフィールドを追加できます。ThemeDataアプリを古いデフォルトに戻すには示されているように:

// Old defaults for a light theme
ThemeData(
  textSelectionTheme: TextSelectionThemeData(
    cursorColor: const Color.fromRGBO(66, 133, 244, 1.0),
    selectionColor: const Color(0xff90caf9),
    selectionHandleColor: const Color(0xff64b5f6),
  )
)

// Old defaults for a dark theme
ThemeData(
  textSelectionTheme: TextSelectionThemeData(
    cursorColor: const Color.fromRGBO(66, 133, 244, 1.0),
    selectionColor: const Color(0xff64ffda),
    selectionHandleColor: const Color(0xff1de9b6),
  )
)

新しいデフォルトで問題ない場合は、しかし、ゴールデンファイルテストに失敗した場合、を使用してマスターゴールデンファイルを更新できます。次のコマンド:

$ flutter test --update-goldens

タイムライン

リリースされたバージョン: 1.23.0-4.0.pre
安定版リリース: 2.0.0

参考文献

API ドキュメント:

TextSelectionThemeData
ThemeData